home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / graphvew / pixlzh.arj / PIXLZH.COM / PIXFX.DOC next >
Text File  |  1990-12-23  |  16KB  |  428 lines
  1.  
  2.                            pixFX Documentation
  3.                         Version 2.1  December 1990
  4.  
  5.  
  6.                  Copyright (C) 1990  Golden Hind International
  7.                             All rights reserved 
  8.  
  9.  
  10.  
  11.  Introduction
  12.  ------------
  13.  
  14.  pixFX is an IBM PC program for displaying GIF images from 2 to 256 colors 
  15.  on an SVGA 640 x 480 x 256, VGA, or EGA display system.  pixFX combines
  16.  ease of operation with many new features previously not available in
  17.  GIF viewers.  These features include:
  18.  
  19.  - pictures are automatically scaled to full screen size and displayed with 
  20.    the correct aspect ratio.
  21.  
  22.  - pictures using more than 16 colors such as scanned photographs are
  23.    displayed with automatic contrast and brightness control, and automatically
  24.     color-reduced if necessary.
  25.  
  26.  - many special effects are available, including photographic and digital
  27.    image processing operations.
  28.  
  29.  - the special 360 x 480 x 256 color mode is supported on IBM compatible
  30.    VGA displays.  Because of the automatic scaling, VGA users can see
  31.    practically all GIF images in near Super VGA quality.
  32.  
  33.  pixFX is both educational and fun!  
  34.  
  35.  
  36.  Installation
  37.  ------------
  38.  
  39.  To install pixFX, simply execute the archived program to extract the
  40.  PIXFX.EXE module.  When executed pixFX will automatically detect which video
  41.  hardware is available and use the mode which gives the best possible
  42.  resolution.  In some cases pixFX may not correctly recognize the video
  43.  hardware, in which case the video mode may be overridden by setting the
  44.  PIXFX environment variable.  See the video modes section of this document
  45.  for details.
  46.  
  47.   
  48.  Operation
  49.  ---------
  50.  
  51.  pixFX may be operated either from the DOS command line, or interactively.
  52.  The format of the commands is the same in both cases.
  53.  
  54.  DOS command line:
  55.  
  56.  To display a GIF picture, issue the command:  pixfx [options] GIFfilename
  57.  
  58.  Example:  pixfx -b150 -m -v vga256 picture.gif
  59.  
  60.  Interactive:
  61.  
  62.  Invoke the program pixFX without any parameters.  A command line is 
  63.  displayed for entering options.  This command line may be edited with the
  64.  left and right arrow keys, the Delete, Backspace, Home, and End keys.
  65.  
  66.  The GIF files in the current directory are displayed, and the currently
  67.  selected file is highlighted.  If no file name is entered on the command
  68.  line, the currently selected file is used.
  69.  
  70.  To select a particular file from the current directory, use the up and down
  71.  arrows.  The Tab and Shift-Tab keys may be used to move between columns
  72.  of the displayed directory.  The Page Up and Page Down keys are used to move
  73.  between different pages of the displayed directory if it does not fit on
  74.  one page.
  75.  
  76.  To switch to any other directory or drive, simply type its name by itself
  77.  on the command line, e.g.  D:\GRAPH   
  78.  
  79.  Options
  80.  -------
  81.  
  82.  Options are provided for further control the operation of pixFX, and to 
  83.  product special effects.  Each option is a minus sign followed by a letter
  84.  with no intervening space.  Some options require a numeric parameter,
  85.  as shown in the list below.
  86.  
  87.  The format of the options list follows UNIX (tm) conventions - case is
  88.  significant!  Options may be mixed in any combination.  pixFX can
  89.  make sense out of unusual values of some parameters - e.g. a negative
  90.  value or a very large value for contrast.  The possibilities are endless! 
  91.  
  92.  Flags 
  93.  -----
  94.  
  95.  -h   halftone
  96.  
  97.       Halftoning is available for both monochrome (B&W) and color pictures.
  98.       B&W halftoning uses only black and white to simulate all shades of
  99.       gray.  Color haftoning uses 8 colors (black, white, red, blue, green,
  100.       cyan, magenta, and yellow) to simulate all colors in all shades.
  101.  
  102.         (Pictures that are to be printed are normally halftoned because most
  103.       printers can only place ink at full density on paper.  There are
  104.       two basic methods of halftoning: the one most widely used in the
  105.       printing industry uses dots of variable size; the other uses fixed
  106.       size dots.  The second method is used in most printers attached to
  107.       computers, and is becoming more popular.) 
  108.  
  109.       pixFX V2.1 uses the well-known Bayer dithering matrices for halftoning.
  110.       There are several other halftoning methods available based on
  111.       a concept known as error diffusion. Because of the popularity of
  112.       300 dpi laser printers there is a growing need for high quality
  113.       computer algorithms for halftoning.  Golden Hind International is
  114.       actively researching this technology.
  115.  
  116.  -i   information
  117.  
  118.       The dimensions of the GIF image and the number of colors are displayed
  119.       on the status line.
  120.  
  121.  -m   monochrome
  122.  
  123.       Colors in the picture are converted into shades of gray, similar to
  124.       B&W TV or a B&W photograph.  pixFX uses the television standard for
  125.       monochrome conversion, the NTSC Y luminance component of a color picture.
  126.  
  127.  -n   negative
  128.  
  129.       Colors and shades of gray are inverted, giving the appearance of a
  130.       photographic negative.  (Color photographic negatives include an
  131.       orange mask, so they don't appear as true negatives.)
  132.  
  133.  -s   solarize
  134.  
  135.       When photographic film is highly overexposed, as for example by 
  136.       pointing at the sun, areas of high light intensity may end up dark.
  137.       This characteristic is now used intentionally as a special effect
  138.       known as "solarization".
  139.       
  140.       (For pixFX to solarize a picture, the contrast must be set at a value
  141.       considerably higher than 100%.  Because most pictures with more than
  142.       16 colors are displayed with an automatic contrast setting considerably
  143.       greater than 100%, it is usually not necessary to specify a contrast
  144.         setting.)  
  145.            
  146.  -Y   false color
  147.  
  148.       The colors of the picture are intentionally changed:  green becomes
  149.       red, blue becomes green, and red becomes blue.  False color is an
  150.       image processing operation which can be used to bring out hidden 
  151.       aspects of a picture because the psychological link between objects
  152.       and their normal colors is broken.  Infrared pictures are one form
  153.       of false color.
  154.  
  155.  -Z   pseudo color
  156.  
  157.       Different shades of gray are displayed instead as different colors.
  158.       Pseudo color can be used to bring out features in monochrome pictures
  159.       that might otherwise be missed.
  160.  
  161.       (Because pseudo color only takes a monochrome input, pixFX will convert
  162.       a color picture to monochrome first.)
  163.  
  164.  
  165.  
  166.  Parameters
  167.  ----------
  168.  
  169.       All these options take a numeric value following the option, separated
  170.       by a space.  Most options take an integer value.  This options which
  171.       require a real value are specifically identified in the following
  172.       list.
  173.  
  174.  -a   picture aspect ratio
  175.  
  176.       The picture aspect ratio is its width divided by its height.
  177.       pixFX can usually determine a picture's aspect ratio, but sometimes
  178.       it may be necessary to override this decision.
  179.  
  180.       For reference, the aspect ratio of the screen on a personal computer is
  181.       4/3 or 1.333, the same as TV.  A different aspect ratio of 6/5 is
  182.       common on workstations.  (Note that the aspect ratio of a picture is NOT
  183.       always the number of pixel columns divided by the number of pixel rows.)
  184.  
  185.       If you want to test that your monitor's vertical height and
  186.       horizontal widths are adjusted to their correct values, display a 
  187.       picture with the aspect ratio forced to 1.000 and measure the 
  188.       picture on the screen.
  189.  
  190.  -b   brightness
  191.  
  192.       This option sets the overall brightness of the picture.  The parameter
  193.       is expressed in percent, with the default being 100% for 2-16 color 
  194.       pictures.  For 32-256 color pictures, the default brightness is set
  195.       automatically, depending on the overall brightness of the original image.
  196.  
  197.       Automatic brightness adjustment is turned off for any image whose
  198.       filename is of the form PIXFX*.GIF.
  199.  
  200.  -c   contrast
  201.  
  202.       This option sets the overall contrast of the picture.  The parameter
  203.       is expressed in percent.  The default for 2-16 color pictures is
  204.       100%, while the default for 32-256 color pictures is set automatically,
  205.       depending on the overall contrast of the original image.  For many
  206.       images, the default contrast setting will be in the range 150-175%.
  207.  
  208.       Automatic contrast adjustment is turned off for any image whose
  209.       filename is of the form PIXFX*.GIF.
  210.  
  211.  -g   gamma
  212.  
  213.       Most cameras and monitors do not exhibit a linear response between
  214.       light intensity and film density or electrical signal levels. This
  215.       non-linearity is expressed as gamma, the exponent of the algebraic
  216.       power relationship between light intensity and film density or
  217.       electrical signal.
  218.  
  219.       Thus:
  220.             film density = a * (light intensity) exp gamma
  221.       
  222.       The gamma option in pixFX applies an additional correction. The default
  223.       is 1.0 - a value less than 1.0 reduces contrast, while a value greater
  224.       than 1.0 increases contrast.  Gamma correction is carried out by pixFX
  225.       before any other options.
  226.  
  227.  -o   ordered dither
  228.  
  229.       Each pixel has some ordered dither added to it.  The dither value is
  230.       based on the 4 x 4 Bayer dithering matrix.  The maximum amount of dither
  231.       is plus or minus 1/2 the parameter value (the R, G, and B component
  232.       of each pixel is encoded in the range 0 to 255).
  233.  
  234.       Ordered dithering can be used to smooth transitions in images such
  235.       as occurs in sky backgrounds and flesh tones.  The dithering is only
  236.       applied to mid-range values.  See also the -r parameter.
  237.  
  238.  -p   posterize
  239.  
  240.       Posterizing is a special effect where a limited range of colors or shades 
  241.       of gray are used to display a picture.  The parameter specifies the
  242.       number of levels to be used - 2, 3 or 4.  
  243.  
  244.  -r   random dither
  245.  
  246.       Each pixel has some pseudorandom noise added to it.  (The pseudo-
  247.       random noise on pixFX is "blue" noise, which has had the low
  248.       frequency component removed for better appearance.)  The parameter
  249.       specifies the total range over which an individual pixel can vary,
  250.       based on black being 0 and white 255.
  251.  
  252.         Random dithering can be used to smooth out transitions in images and
  253.       also to generate special effects.  (Try -p 2 -m -r 128.)
  254.       The dithering is only applied to midrange values.  See also the
  255.       -o parameter.  Random and ordered dithered can be used in combination
  256.       if desired.  
  257.  
  258.  -v   video mode
  259.         
  260.       See the separate section on video modes.
  261.  
  262.  -x   x offset
  263.  
  264.       This parameter is the x location in the picture corresponding to the
  265.       center of the screen.  Allowable values are -100 to +100, with the
  266.       default being 0.  The main use of this option is for pictures scaled
  267.       at more than 100%.
  268.  
  269.  -y   y offset
  270.  
  271.       This parameter is the y location in the picture corresponding to the
  272.       center of the screen.  Allowable values are -100 to +100, with the
  273.       default being 0.  As for the x offset option, the main use of this
  274.       option is for pictures scaled at more than 100%.
  275.  
  276.  -z   scale factor
  277.  
  278.       At the default value of 100% pixFX automatically scales each picture
  279.       so that it fills as much of the screen as possible, while still
  280.       maintaining the correct aspect ratio.  Pictures may also be displayed
  281.       at more or less than full size by setting the scale factor option.
  282.  
  283.       The scale factor option is intended to be used in conjunction with the
  284.       x offset and y offset options.  For example, the options:
  285.         -x 100 -y 100 -z 300
  286.       will magnify the picture 3 times, and place the top right corner of
  287.       the picture in the exact center of the screen.
  288.  
  289.  -A   hue
  290.  
  291.       This parameter corresponds to the tint control on a color TV.
  292.       Allowable values are from -100 to +100, with the default being 0.
  293.  
  294.       The hue option works by adjusting the equivalent NTSC I and Q 
  295.       color TV signal components.
  296.  
  297.  -B   saturation
  298.  
  299.       This parameter corresponds to the color control on a color TV.
  300.       The default is 100%.  Setting saturation to 0 will generate a
  301.       monochrome picture.
  302.  
  303.       Similar to the hue option, the saturation option works by adjusting
  304.       the equivalent NTSC I and Q color TV signal components.
  305.  
  306.  
  307.   The options for brightness and contrast of individual colors are grouped
  308.   together below.  The default for these values is 100%.  Note that these
  309.   values multiply the overall picture brightness and contrast values set by 
  310.   the -b and -c parameters.
  311.  
  312.  -C   red brightness
  313.  
  314.  -D   red contrast
  315.     
  316.  -E   green brightness
  317.  
  318.  -F   green contrast
  319.  
  320.  -G   blue brightness
  321.  
  322.  -H   blue contrast 
  323.  
  324.  -I   yellow brightness
  325.  
  326.  -J   yellow contrast
  327.  
  328.  -K   magenta brightness
  329.  
  330.  -L   magenta contrast
  331.  
  332.  -M   cyan brightness
  333.  
  334.  -N   cyan contrast
  335.  
  336.  
  337.  -X   pixelation
  338.  
  339.       The picture is subdivided into squares, with each square displaying the
  340.       average color of the original picture.  (The picture appears as though it
  341.       is being displayed with very coarse pixels, hence the name pixelation.) 
  342.       The parameter is the number of squares to be used along the width of
  343.       the picture.  (Values of 20 to 40 give good results.)
  344.  
  345.       Note that this special effect is generated AFTER the original picture
  346.       has been displayed.
  347.  
  348.  Video Modes
  349.  -----------
  350.  
  351.  There are 3 ways of specifying which video mode pixFX will use to display
  352.  images:
  353.  
  354.  If no mode is specified, pixFX will automatically detect the available
  355.  hardware and choose the highest mode available - SVGA, VGA or EGA.  (Because
  356.  of the automatic scaling performed by pixFX, the user normally does NOT need
  357.  to specify the video mode needed to display any particular image.)   
  358.  
  359.  The default video mode may be specified by setting the PIXFX environment
  360.  variable, e.g. SET PIXFX=VGA256X 
  361.  
  362.  The video mode may be set for an individual image on the command line by using
  363.  the -v option, e.g. -v tseng  (Tseng SuperVGA adapter in 640 x 480 x 256 mode.)
  364.  
  365.  The video modes supported by pixFX are:
  366.  
  367.       ega       640 x 350 x 16 colors
  368.       vga       equivalent to vga16 for 16 color images
  369.                           and vga256 for 256 color images
  370.       vga16     640 x 480 x 16
  371.       vga256    320 x 200 x 256
  372.       vga256x   360 x 480 x 256  (most VGA compatible adapters)
  373.       svga      640 x 480 x 256  (autodetect type - must have at least 512K)
  374.  
  375.   Specific SuperVGA adapters may also be selected in 640 x 480 x 256 color mode:
  376.       aheada, aheadb, ativga, chipstech, everex, oaktech,
  377.       paradise, trident, tseng, tseng4, video7 
  378.  
  379.  
  380.  Appendixes
  381.  ----------
  382.  
  383.  Release Notes
  384.  -------------
  385.  Version 2.1  December 1990.
  386.  
  387.       One page limitation on GIF directory display removed.  Ordered dither
  388.       and random dither parameters added.  Miscellaneous bugs corrected.
  389.  
  390.  Version 2.0  December 1990.
  391.  
  392.       Support added for 256 color mode on most SVGA adapters with at least 512K
  393.       of memory, and on VGA adapters, including the special 360 x 480 x 256
  394.       color mode. 
  395.  
  396.       Commands may be entered and edited interactively for files selected from
  397.       a directory listing.  
  398.  
  399.       On-line help system added.
  400.  
  401.  
  402.  Version 1.0  October 1990.
  403.  
  404.       640 x 350 x 16 color display mode on EGA displays.
  405.  
  406.       Commands entered from DOS command line only. 
  407.  
  408.  
  409.  Trademarks:
  410.  ----------
  411.  
  412.       pixFX is a trademark of Golden Hind International.  
  413.       GIF is a service mark of Compuserve Incorporated.
  414.       IBM PC is a trademark of International Business Machines Corporation.
  415.       UNIX is a trademark of AT&T.               
  416.  
  417.  Distribution
  418.  ------------
  419.  
  420.       The file PIXLZH.COM is a self-extracting archive containing the following
  421.       files:
  422.  
  423.       READ.ME            Licensing and distribution information
  424.       PIXFX.DOC          Instructions for installation and use (this file)
  425.       PIXFX.EXE          Executable module of pixFX
  426.  
  427.  
  428.                               * * *